table of contents
GETPEERNAME(2) | Linux - příručka programátora | GETPEERNAME(2) |
JMÉNO¶
getpeername - vrať adresu vzdáleného konce soketu
SYNTAXE¶
#include <sys/socket.h> int getpeername(int s, struct sockaddr *name, int *namelen);
POPIS¶
Getpeername vrací jméno (adresu) počítače, který je na druhém konci soketu. s. Parametr namelen by měl být inicializován tak, aby indikoval velikost paměťového prostoru, na který ukazuje argument name. Po návratu bude obsahovat aktuální velikost vrácené adresy (v bajtech). Jméno je příslušně zkráceno, je-li velikost příliš malá.
NÁVRATOVÁ HODNOTA¶
V případě úspěchu je vrácena 0, jinak -1 a proměnná errno je příslušně nastavena.
CHYBY¶
- EBADF
- Argument s není platným deskriptorem.
- ENOTSOCK
- Argument s je deskriptorem souboru, není to soket.
- ENOTCONN
- Soket není spojen.
- ENOBUFS
- Systém nemá k dispozici dostatek vnitřních zdrojů, aby mohl tuto operaci provést.
- EFAULT
- Argument name ukazuje na paměť, která se nenachází v platné části adresového prostoru procesu. EINVAL Namelen je neplatné(například záporné číslo).
SPLŇUJE STANDARDY¶
SVr4, 4.4BSD (volání getpeername se poprvé objevilo ve 4.2BSD), POSIX.1-2001 . Třetí argument getpeername() je ve skutečnosti int * (použito v 4.x BSD a libc4 a libc5). Některé zmatky okolo POSIXu vyústily v přítomnost socklen_t, které je také užíváno v glibc. Viz accept (2).
DALŠÍ INFORMACE¶
TIRÁŽ¶
Tato stránka je součástí projektu Linux man-pages. Popis projektu a informace o hlášení chyb najdete na http://www.kernel.org/doc/man-pages/.
25. září 2009 | BSD Man Page |